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1. About this guide 


Objectives and target audience 


This guide describes how to install and configure the Skrill Oxid module on Oxid. It assumes that you 
have an existing Oxid installation. If there is no distinction between Oxid 5 and Oxid 6 it should be 
considered that there is no difference in the relevant set up. 


Conventions used in this guide 
The table below lists some of the conventions used in this guide. 


Table 1-1: List of conventions 


Code example Used to illustrate example code, functions and commands. 
File path Used to indicate a file path or folder structure. 


Menu1 > Menu option2 > Indicates a menu path. 
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2. Introduction 


What is the Oxid module? 


Oxid is an eCommerce platform, which provides online merchants with a flexible shopping cart 
system, as well as control over the look-and-feel, content and functionality of their online store. 


Oxid has been fully integrated with Skrill’s online payment solution called Quick Checkout. Installing 
and configuring the Skrill Payment Solution module provides a simple, secure and convenient option 
for connecting to Skrill’s online payment processing platform via Oxid. 


Skrill customers using Oxid have access to a wide range of card and alternative payment methods. 


Signing up for a Skrill account 


Before you can start accepting payments through Skrill, you need to open a free merchant account by 
completing the online application form here. 


Once your application has been approved you can configure your Skrill credentials in your Skrill 
merchant account and then copy them in the your Oxid backend and start taking payments. 
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3. Installing and configuring Oxid 


Secret Word and API Password 

It is mandatory to setup a secret word and API/MQI password for your Skrill merchant account before 
configuring the Skrill Oxid module. The secret word is used to authenticate the data sent back to your 
Oxid server after payment. You must obtain the IP address of your Oxid server to configure the 
API/MQI password. You can find this IP address by executing the following command from a 
command prompt: 


ping <server domain name> 


For example: 
ping example.oxidserver.com 
Pinging example.oxidserver.com [145.76.160.206] with 32 bytes of data: 


Make a note of the set of numbers in the square brackets. This is the IP address. Now you have the IP 
address, you can setup the secret word and API/MQI password as follows: 


1. Log into your Skrill merchant account at www.skrill.com 

2. Goto Settings > Developer Settings (Figure 3-1) 

3. Set API / MQI Password using the toggle, type and confirm by clicking Save 

4. For each section, specify the IP address(es) or IP address range of your Oxid server. This 
prevents payment or money transfer requests from other IP addresses if your secret word 
or API password is compromised. All requests from other IP addresses are denied. Access 
can be granted to: 


e Asingle IP address (e.g. 145.76.160.206 using the example above) 
e Multiple IP addresses, separated by space (e.g. 192.168.0.2 10.0.0.2) 


e A subnet in CIDR notation (e.g. 192.168.0.0/24) 


5. Set Secret Word using the toggle, type and confirm by clicking the Save button 
Note: Your Secret Word must contain at least: 8 characters, 1 uppercase letter, 1 lowercase 


letter, and 1 number. 
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Developer Settings 
‘ oa API and security settings for your wallet account 


Bla Bla Wallet 
ID: 116404455 
@} Balances Developer Settings : Bla Bla Wallet Hil ma BE H5 2E = Fi kba Fol 5 25 m 


Wallet IP Whitelisting API / MQI / GSR / CVT Management API Documentation 


[C] Automated Payment Interface (API) Disabled D 


© Settings 
Allow requests to the API only from the following IP addresses. 








Your API secure IP addresses: 





E3 Developer Settings 
87.120.141.129 


[-) Merchant Query Interface (MQI) Disabled 


Allow requests to the MQI only from the following IP addresses. 


Your MQI secure IP addresses: + Add } 


No active secure IP address found 
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[=] Gateway Secure Restriction (GSR) Disabled 


Allow gateway sessions to be generated only from the following IP addresses. 





Your GSR secure IP addresses: 





[=] Set API /MQI Password Enabled 


Please provide API/MQI Password in order to enable the service. 


Current Password 


©] SetSecretWord Enabled 


Please provide Secret Word in order to enable the service. 


New Password 


Confirm Password 


Co © 


tings | Privacy Notice | Regulatory Disclosures | Cookie Notice 





© 2020 Paysafe Holdings UK Limited. All rights reserved. Sirill® is a registered trademark of Paysafe Holdings UK Limited. Skrill Limited is registered in England and Wales with company number 04260907 and its registered office at 25 Canada Square, London E14 SLO. Authorised and regulated by the Financial Conduct 


Figure 3-1: Configuring a Secret Word and API/MQI Password 


Download Skrill 


1. After successful download of thezip file, the extension is installed as follows: 

2. Decompress zip file (into a temporary directory) 

3. Adapt the decompressed files and directories according to the current status of the OXID 
installation group and user access rights 

4. Copy content of the directory “src” into the OXID main directory, thus overwriting the 
previous files/directories 

5. Delete complete OXIDcache 

6. Log out from the Backoffice area of your OXID shop and log in again to update the rights 
management for the Backoffice user 


Configure Skrill 
1. Login to your Oxid admin account. 
2. Click Skrill Hosted Payment Solution from the left side menu 
3. Click on Setting 
4. Goto General Settings and fill in the required details (Figure 3-2) 
5. Click Save 
6. Make sure the Skrill plugin is activated under Extensions — Modules — Skrill Hosted Payment 


Solution — Overview 
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About Skrill General Setting Payment Configuration 


Merchant ID * 
Your Skrill customer ID, It is displayed in the upper-right corner of your Skrill account. 


Merchant Account (email) * 
Your Skrill account email address, 


API Password * 


When enabled, this feature allows you to issue refunds and check transaction statuses. To set it up, you need to login to your Skrill account and go to Settings -> then, Developer 
Settings. 


Secret word This feature is mandatory and ensures the integrity of the data posted back to your servers, To set it up, you need to login to your Skrill account and go to Settings -> then, 


Developer Settings. 


Recipient 
A description to be shown on Quick Checkout. This can be your company name {max 30 characters). 
Logo Uri The URL of the logo which you would like to appear at the top night of the Skrill page. The logo must be accessible via HTTPS or it will not be shown. For best results use logos with 
dimensions up to 200px in width and 50px in height. 
Shop Uri 
IFrame Y 
Display 


iFrame — when this option is enabled the Quick Checkout payment form is embedded on your website, Redirect — when this option is enabled the customer is redirected to the Quick 
Checkout payment form , This option is recommended for payment options which redirect the user to an external website. 


Merchant Email 


Your email address to receive payment notification. 





Figure 3-2: Skrill Settings with example values in Oxid 5 backend 


Configure the Skrill Settings as follows 


1. Enter your Skrill Merchant account ID in the Merchant ID field. This is the Customer ID of your 
merchant account 


2. Enter your Skrill Merchant account email address 

Enter the API password and Secret word that you set up in the previoussection 

4. Select a display option for the Skrill Payment Form (Iframe or redirect). See Table 3-1 below 
for a detailed explanation of all Skrill settings 

5. Either enter a name for your store in the Recipient field to display to customers within the 
Skrill Payment Form 

6. Optional - Enter a URL of a logo to be displayed on the Skrill Payment Form in place of the 
Recipient text. This URL must be in HTTPS format (begin with https://) 


ia 


Table 3-1: Skrill Settings 


Your unique merchant identifier. This is the 58010731 
Customer ID of your merchant account. 


The email address linked to your Skrill merchant | techpubs@skrill.com 
account (created by you when you first signed up 
for a Skrill merchant account). 


Merchant ID 


Merchant 


Account (email) 
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Logo URL 


Shop URL 
API Password 


Display 


Optional - A description of your shop. This will Demo Shop 
be displayed on the Skrill Payment Form if you 
do not provide a Logo URL. 


Optional - Link to the URL of a logo, to be https://www.skrill.com/ 
displayed on the Skrill Payment Form. Must be in | fileadmin/content/pdf/ 
HTTPS format. acme.png 





URL for the home page of your shop without the | https://myshop.com 
index.php e.g. if your shop is located at 

https://myshop.com/index.php you would enter 

https://myshop.com 





The API password. This field is mandatory. It 
allows the Oxid server to receive payment 
information. 


ensures the integrity of the data posted back to 
your Oxid servers. 





Enter the secret word configured for your Skrill N/A 
account here. This feature is mandatory and 


This setting has two options: IFrame and Redirect | IFrame 
IFrame - when IFrame is enabled the Skrill 
Payment Form is embedded in your shop 
website. See Figure 3-3: for anexample. 
Redirect - when redirect is enabled the 
customer is redirected to the Skrill Payment 
Form. This form is displayed on its own in 
the current browser tab. This option is 
recommended if you plan to display 
Payment Methods which redirect the user 
to an external website such as Klarna, 
Rapid Transfer, etc. 
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1. Cart 2. Address 3. Pay 4. Order Ready! 


@ English Germany 


28.85r © Skrill 
= 


VISA 


Card number 


Expiry date Security code 
MM YY CVV 


Cardholder name 


Type the name exactly as it appears on the card 


PAY NOW 


Cancel 





renon Powered by 


Skrill 


Figure 3-3: Iframe (embedded) option 


10 


Skrill Oxid Module Configuration Guide 1.0 


4. Displaying Payment Methods 


You can select the payment methods to display to your customer using the Payment Configuration 
tab. The module has a series of payment method sections for each of the payment methods supported 
by Skrill. An example is displayed in Figure 4-1: 


VISAS Credit Card / Visa, Mastercard, AMEX @ Enabled Show Separately 


Figure 4-1: Example Payment method section 


For each payment method, specify whether it should be displayed or not (enabled or not Table 4-1) 
in the list of Payment methods displayed in the Oxid Checkout. Hover over the “2?” symbol to the 
right of each payment method to see the countries where it is available. See the Skrill Quick 
Checkout Integration Guide for a full list of countries and an up-to-date list of the countries where 
each payment method is supported. The payment methods are displayed in order of popularity in 
the customer’s country. 


Table 4-1: Payment Method Settings 


Enabled Determines whether this Payment method is displayed - Yes = display, No = 
Do not display. 
Under the Enabled setting is a list of the countries that support this payment 
method. If a Payment method is enabled but the customer’s country is not 


supported (determined by the country set in the billing address the customer 
chose in the Oxid Checkout) then it will not be shown. 


Show Always set this setting to Yes where available. 
Separately 





Please note that if the payment option is not enabled for your Skrill merchant account, enabling in 
from the backend would not make the payment option visible. You will need to contact 


merchantsupport@paysafe.com in order to discuss activating the specific payment option. 


Add countries to Skrill payment methods 
To add countries for each separate payment method, please follow the below steps: 


Click on shopping setting 

Select payment methods 

Choose the payment method 

Click on country from the tabs below 

Select assign countries 

To confirm all changes, click on assign all (Figure 4-2) 


ee SY 
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HOME SHOP'S START PAGE LOGOUT 


OXID eShop 5 . 


MASTER SETTINGS 


SHOP SETTINGS 


yy trie Methi 





Discounts 

Shipping Methods 
Shipping Cost Rules 
Coupon Series 

Gift Wrapping 
EXTENSIONS 
ADMINISTER PRODUCTS 
ADMINISTER USERS 
ADMINISTER ORDERS 
CUSTOMER INFO 


SERVICE 


SKRILL HOSTED 
PAYMENT SOLUTION 


OXID EXCHANGE 
SEAL OF QUALITY 
PAYMENT 


WEB SHOP 
CONTROLLING 





DOD eShop Ad stration] - Google 


Alipay @ Not secure 

All Cards and Alternative Payment Methods 

Sitcoin Drag items between the lists to assing/unassign 
Use * in beginning as wildcard sign 


Cash / Invoice 

Cash in advance 

COD (Cash on Delivery) 
Credit Card 





o Direct Sank Transfer 
o Direct Debit 








Create new Payment Method | Start Holp 


Figure 4-2: Enable countries for payment methods via Skril 
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All Cards and Alternative Payment Methods 


This special payment option launches the Skrill Payment Form with multiple tabs showing all the 
supported Payment methods available in the customer’s country . The logo for this Payment option in 
the Oxid Checkout payment information section is as seen in Figure 4-2 below: 


Skrill 


VISA SY BAAD men: 


Klarna. & peysele 


All Cards and Alternative Payment Methods @ Enabled 





Figure 4-3: Setting up combined Skrill logo 


@ English United Kingdom 


28.85EUR Skrill 


Sp) Skeill PAP/M) nuer 


è eer w ae. 


NERS Powered by 
v Skrill 
Figure 4-4: Multiple log 
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5. Customer Experience 


This section describes the customer's checkout experience when using the Skrill Oxid module. 


Note: We only describe the Checkout process from the payment selection step onwards as the 
previous steps are unchanged. 


The steps are as follows: 


1. Click a payment method from the list of available payment methods (this list depends on 
the customer’s country, the payment options configured for your Skrill account and the 
payment options configured in the Skrill Oxid Module 


1. Cart 2. Address 3. Pay 4. Order Ready! 


Please select your shipping method 
Standard 


Charges: 3,90 € 


Payment method 


O Invoice 
o VISAS 
C RAPID: 

O 


Figure 5-1: Oxid Checkout Payment selection showing different payment methods 
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Enter Payment details in the Skrill Payment Form. 


2. Address 3. Pay 4. Order Ready! 


@ English Germany 


791.10e-R © Skrill 


Card number 
5400-0000-0000-000d fusieead 
Expiry date Security code 


10 | 20 23 | - 


Cardholder name 
TESI Customer 


Type the name exactly as it appears on the card 


This payment will be processed as a Skrill Guest payment and 
is subject to the Skrill Privacy Policy. 


PAY NOW 


Cancel 








S recon Powered by 


Skrill 


Figure 5-2: Enter Payment Details in the Skrill Payment Form 
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3. Click Pay Now to complete the payment. If all is correct, the payment form will display the following 
screen: 


1. Cart 2. Address 3. Pay 4. Order Ready! 


&® English Germany 


191.10QEvR Skrill 


S 





Successful payment 


— Powered by 
v Skrill 


Figure 5-3: Successful Payment 


4. Click Continue to return to the Oxid Order Confirmation screen. This screen contains the 
unique order number for this payment. 


1. Cart 2. Address 3. Pay 4. Order Ready! 


Thank you 


Thank you for your order in OXID eShop 4. 
We registered your order under the number: 16 


Unfortunately the e-mail for confirming your order couldn't be sent. 
We will inform you immediately if an item is not deliverable. 


You can go back to start page 


Figure 5-4: Order Confirmation in Oxid Checkout 
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Removing or reducing the header and reducing the footer 
You can request a version of the Skrill payment form without the Skrill header and amount fields. The 
security logo is also removed from the footer, to reduce its size. To enable this option, please contact 
Skrill Merchant Services and ask for the Reduced Header and Footer option. This option is shown in 
the screenshot below (The standard payment form is shown on the left and the reduced header and 


footer option on the right). 


© English France 
10.0Q«v8 
= © 
visa SD 
Expiry date Security code 
MM YY CVV 
Cardholder name 
First Last 
Email address Why? 
PAY NOW 


Káta 


Skrill Z= 


O Engish France 


Expiry date 


` A M YY C y V 


Cardholder name 


First Last 


Email address Why? 


PAY NOW 


Porwered try 


Skrill 


= English 


France 


Expiry date Security code 


MM YY CVV 


Cardholder name 
First Last 


Email address Why? 


PAY NOW 


Powered by Skrill 


Figure 5-5: Reduced Header and Footer Option 
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6. Payment Information 


The Oxid module provides payment information in the Order screen with information about the 
payment method used for an order. 


Billing Address: 
Customer 1 

High Street 3 

E1 7YT London 
United Kingdom 


E-mail: customer! @gmail.com 


Product: 


Order No.: 35 
Cust No.: 10 
In Folder: New ~ 


Internal Status: Payment Accepted 


Overview: 
Number Orders Today: 1 


Sum Revenue Today: 479,00 EUR 


* 1302 Kiteboard CABRINHA 479,00 EUR 
1 * 1302 Kiteboard CABRINHA 479,00 EUR iibi Order TOTAL 52 


Total: Sum Revenue TOTAL: 9.940,53 EUR 
Product Gross Price 479,00 EUR 

Discount - 0,00 EUR Ship Now 
Product Net Price 402,52 EUR bs E z aE 
RIE Send e-mail? J 
VAT (19%) 76,48 EUR 

Charge Payment Method 0,00 EUR 

Sum total 479,00 EUR 

Payment with: Kreditkarte / Visa, Mastercard 

Shipped with: Standard 

Transaction ID: 3278467105 

Used payment method: Visa 

Country (of the card-issuer): United States 

Order originated from: Austria 


Figure 6-1: Payment Information Example 


The Payment Information section includes the following information: 


1. The payment status 
The payment option selected in the Skrill payment form 

3. The country of origin of the payment instrument used (this is only shown for card payment 
methods and bank accounts). For bank accounts, this shows the country where the account is 
registered. For cards, this shows the country where the card was issued 

4. Thecurrency the order was placed in using a 3-digit ISO 4217 currency code e.g. EUR for 
Euros 


Refunding Payments 

The process for Refunding customer payments is as follows: 
1. Goto Skrill Hosted Payment Solution from left side menu 
2. Click on Payment Overview 


3. Search for the customer’s invoice using the customer’s order number orname 


Filter 


Q 
ORDER DATE ORDER ID CUSTOMER AMOUNT PAYMENT DATE PAYMENT TYPE ORDER STATUS ACTION 
06-08-2020 11:03:46 10 Doe, John 129.00 EUR 2020-08-06 11:18:27 Credit Card / Visa, Mastercard Payment Accepted Refund 


Figure 6-2: Search for Order 


4. Check that the details are correct 
5. Select Refund 
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7. Testing 


We provide test cards shown in the table below for use with test merchant accounts. When using these 
card numbers enter an expiry date in the future and a random CVV number. 


Table 7-1: Test Cards 


5438311234567890 





1000001234567890 


Should you wish to test Skrill in DEMO shops please get in touch with Skrill support at 
newbusiness@paysafe.com, so we can provide you with access. 
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